docs: Replace references to --nested with --devkit

The --devkit option is strongly recommended over the old --nested
nowadays, not least because the latter option no longer exists by
default (as it is tied to the X11 backend).

Remove the section on global shortcuts and workaround for looking glass,
as Devkit supports inhibiting keyboard shortcuts.

Part-of: <https://gitlab.gnome.org/GNOME/gnome-shell/-/merge_requests/3871>

diff --git a/docs/building-and-running.md b/docs/building-and-running.md
index 091d523b49e85cae8e5532d3b552747ac8ec201d..ad29c6b28575deaeb6359cc9d482259b837336f3 100644 (file)
--- a/docs/building-and-running.md
+++ b/docs/building-and-running.md
@@ -61,25 +61,15 @@ Refer to the [README][toolbox-tools] for further information on the scripts.
 
 ## Running a nested instance
 
-It is possible to run gnome-shell as "nested" instance in a window.
+It is possible to run gnome-shell as nested instance using Devkit.
 
 The `run-gnome-shell` script will automatically do that when run from
 a graphical session, or you can run the following command:
 
 ```sh
-$ WAYLAND_DISPLAY=shell-test-1 dbus-run-session \
-    gnome-shell --wayland-display=shell-test-1 --nested
+$ dbus-run-session gnome-shell --wayland --devkit
 ```
 
-There are limitations to the nested instance, such as keyboard shortcuts
-usually not getting to the nested compositor.
-
-In order to still bring up the [Looking Glass][lg] debugger, you can
-use an [extension][lg-button] as workaround.
-
-[lg]: ./looking-glass.md
-[lg-button]: https://extensions.gnome.org/extension/2296/looking-glass-button/
-
 ## Native
 
 Sometimes it's necessary to run the "native backend", on real display hardware.